Propiedades

Este endpoint permite extraer la información de propiedades asociada a un RUT previamente cargado en tu cuenta de Sheriff.

• No se generará ningún costo adicional al consultar información de un RUT ya cargado en la plataforma.
• Asegúrate de que el RUT esté pre-cargado en la plataforma antes de intentar extraer su información.

Detalle de API

Request

• URL: /helper/bienes/{rut}/propiedades
• Método: GET

Parámetros

• rut (requerido): El RUT del cual se desea extraer la información. Formato del rut "12345678-9".

Ejemplo request con curl

curl -X 'GET' \
  'https://prod.api.thesheriff.cl/api/clients/v2/helper/bienes/12345678-9/propiedades'\
  -H 'accept: application/json' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9EjemploDeToken123' \
  -H 'x-client-identifier: SheriffSecureClient-v1'

Response

Success

• Status code: 200

• Example response body:

  {
    "success": true,
    "data": {
      "cantidad": 2,
      "casos": [
        {
          "manzana": "100",
          "predio": "400",
          "comuna": "Rancagua",
          "direccion": "Direccion 1",
          "tipoPropiedad": "AGRICOLA",
          "destino": "AGRICOLA",
          "avaluo": 20000000
        },
        {
          "manzana": "100",
          "predio": "401",
          "comuna": "Rancagua",
          "direccion": "Direccion 2",
          "tipoPropiedad": "NO AGRICOLA",
          "destino": "INDUSTRIA",
          "avaluo": 30000000
        }
      ],
      "ultimaActualizacion": "24-11-2025 10:00:00"
    }
  }

  A continuación se describen los campos devueltos en la respuesta JSON.

  Campo	Tipo	Descripción
  success	bool	Indica si la operación fue exitosa.
  data	object	Objeto que contiene el total en cantidad, la lista de casos y ultimaActualizacion.

  Campos dentro de data:

  Campo	Tipo	Descripción
  cantidad	number	Número total de propiedades encontradas (ej: 2).
  casos	array	Lista de objetos, uno por cada propiedad encontrada.
  ultimaActualizacion	string	Fecha y hora de la última actualización en formato "dd-MM-YYYY HH:mm:ss".

  Estructura de cada objeto dentro de casos:

  Campo	Tipo	Descripción
  manzana	string	Identificador de manzana del predio.
  predio	string	Identificador del predio.
  comuna	string	Comuna donde se ubica la propiedad.
  direccion	string	Dirección de la propiedad.
  tipoPropiedad	string	Tipo de la propiedad (ej: "AGRICOLA", "NO AGRICOLA").
  destino	string	Destino o uso de la propiedad (ej: "INDUSTRIA").
  avaluo	number	Avaluo monetario de la propiedad en moneda local.

  Nota: Los campos marcados como "No" pueden no estar presentes o ser null según disponibilidad de datos en la fuente.

  Glosario de Términos

  Para una referencia completa consulta el Glosario de Términos. En particular, revisa las definiciones de tipoPropiedad, destino, avaluo, manzana, predio y comuna.

  Errores

  400 - Solicitud inválida

  {
    "success": false,
    "code": 400,
    "error": "Solicitud inválida"
  }

  401 - No autorizado

  {
    "success": false,
    "code": 401,
    "error": "No autorizado"
  }

  403 - No tienes permiso para acceder a este recurso

  {
    "success": false,
    "code": 403,
    "error": "No tienes permiso para acceder a este recurso"
  }

  404 - Recurso no encontrado

  {
    "success": false,
    "code": 404,
    "error": "Recurso no encontrado"
  }

  408 - Tiempo de espera agotado

  {
    "success": false,
    "code": 408,
    "error": "Tiempo de espera agotado"
  }

  429 - Demasiadas solicitudes

  {
    "success": false,
    "code": 429,
    "error": "Demasiadas solicitudes"
  }

  500 - Error interno del servidor

  {
    "success": false,
    "code": 500,
    "error": "Error interno del servidor"
  }